Release 10.1A: OpenEdge Development:
Progress 4GL Reference

STOP-PARSING( ) method

Causes the parser to stop parsing the XML document. This lets an application search for particular data, then abort the parse as soon as the data are found.

Return type: LOGICAL

Applies to: SAX-reader object handle

Syntax

STOP-PARSING ( )

STOP-PARSING( ) can stop a parse started by SAX-PARSE( ), SAX-PARSE-FIRST( ) or SAX-PARSE-NEXT( ). That is, the parse can be single call or multiple scan.

STOP-PARSING sets the PARSE-STATUS attribute to SAX-COMPLETE.

Within a callback, to invoke STOP-PARSING( ), use the SELF system handle, as shown in the following fragment:

SELF:STOP-PARSING( ).

If STOP-PARSING( ) is invoked in a callback or in any procedure called directly or indirectly by a callback, Progress continues to execute the callback as usual, but when the callback finishes, control returns to the next 4GL statement after the most-recently-executed SAX-PARSE( ), SAX-PARSE-FIRST( ), or SAX-PARSE-NEXT( ).